TreeGrid Master / Detail Tutorial
1. Simple nested master detail
Simple master detail relation with detail tables shown as children of master rows
-
Data rows in master detail relation are always defined only in master grid. Changes in both tables are also uploaded only from master grid.
In simple nested relation are detail data defined as children of one child of master rows.
-
In master rows define one child row ("detail parent") that will show the nested grid in one of its cells.
In the detail parent row children define the detail rows to be shown in the nested detail grid.
-
In the detail parent row define attribute
DetailCol
to column name where to show the detail grid.
It is often good to span more (or even all) cells in this row to have more room for the detail grid. Use row attribute Spanned and cell attribute Span.
-
In the detail parent row define attribute
DetailLayout
to specify XML/JSON layout for the detail grid. It can direct XML/JSON string or URL to download the data from.
If you need to set more options for the detail grid data sources, you can use DetailTreeGrid attribute instead.
-
In the detail parent row define attributes Expanded='0' CanExpand='0' to not show the detail children in master grid.
-
Oposite to external detail grids you don't need to define the detail columns in master grid.
If you use debug='check' to check errors in your XML, you will receive warnings for unknown attributes for these columns in detail rows. In this case you can ignore these warnings. Or list them in DebugCheckIgnore.
-
You can set attributes Sync and SyncId and optionally CfgId to synchronize all the detail grids.
For example if a user changes size of column in one detail grid, all other detail grids will be resized accordingly. Similarly for sorting, filtering, grouping and search settings.